home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / spoker10.zip / SPOKER.DOC < prev    next >
Text File  |  1993-03-31  |  17KB  |  442 lines
  1.  
  2.  
  3.                        ============================
  4.                                Strip Poker!
  5.                        ============================
  6.                            (c)1993 T&J Software
  7.  
  8.         One of the T&J Software Collection of multi-BBS door programs.
  9.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  10.               UltraBBS, Telegard, TriBBS, Remote Access, and WWIV
  11.  
  12.                      VERSION 1.0     April 1, 1993
  13.  
  14.                                    By
  15.  
  16.                             Tom & Jane Wildoner
  17.                              397 West Broadway
  18.                               Jim Thorpe, PA
  19.                                   18229
  20.                             VOICE (717)325-9480
  21.                    *between 5:30 & 10:00 p.m. Eastern Time
  22.  
  23.                                   From
  24.  
  25.                                The T&J BBS
  26.                               (717)325-9481
  27.                         1200/2400/9600/19200/38400
  28.                                24 Hours/Day
  29.  
  30. LATEST VERSION:
  31. ===============
  32.  
  33. Please call the T&J BBS for the latest version of this program.
  34.  
  35. LEGALITIES:
  36. ===========
  37.  
  38. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  39. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  40. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  41. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  42. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  43. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY. ONCE REGISTERED, ANY
  44. DISTRIBUTION OF THE REGISTERED KEY WILL INVALIDATE YOUR KEY IN ALL FUTURE
  45. VERSIONS OF THIS PROGRAM AND NO PRODUCT SUPPORT WILL BE GIVEN. DISTRIBUTING
  46. A REGISTERED KEY FILE WILL ALSO BRING ABOUT CRIMINAL CHARGES.
  47.  
  48. DISTRIBUTION:
  49. =============
  50.  
  51. You may make this file available for downloading from your BBS or you may
  52. upload it to any BBS of your choice, provided that you do not make any
  53. changes to the contents of the archive (ZIP file). The archive and its
  54. individual contents may not be used by any service that charges any money
  55. whatsoever, without the written permission of the author.
  56.  
  57.  
  58. PROGRAM DESCRIPTION:
  59. ====================
  60.  
  61. Welcome to T&J Software's Strip Poker Door! We hope you enjoy the
  62. program!
  63.  
  64. In this door you may play against 20 computer players in Strip Poker!
  65. (10 females and 10 males). When you logon initially, you are asked
  66. which player you want to play against (male or female). A second
  67. screen comes up asking which of the 10 players you wish to play
  68. against.
  69.  
  70. Take a look at their stats! It shows how many hands each one has
  71. won/lost, how many rounds they won/lost, and how much money they've
  72. paid out or have taken in. After you select the player, you're off to
  73. the main menu.
  74.  
  75. At the main menu, you have the following options:
  76.  
  77.  
  78. Q- Quit the current game.
  79.  
  80. T- View the TOP TEN players. (Computer players are included too!!)
  81.  
  82. S- View your statistics. (Hands won/lost and rounds won/lost).
  83.  
  84. V- View the all time high score and last weeks high score. (This door
  85.    resets every monday).
  86.  
  87. 1-9- Enter a 1 through 9 to place your bet! This is straight poker so
  88.    there are no redraws!
  89.  
  90. C- Change opponent. In case you're really getting your ass kicked, you
  91.    may always switch computer players. This is only available after a
  92.    "stripping".
  93.  
  94.  
  95. SCORING:
  96.  
  97. You must bet for each card played. All bets are placed into the pot
  98. until the end of the hand at which time the pot is awarded to the high
  99. hand
  100.  
  101. Remember, if you blow your money before monday, you're done until the
  102. door resets. This door resets with the first player on monday!
  103.  
  104. OTHER INFO:
  105.  
  106. On the main screen, it will always keep track of how many pieces of
  107. clothing you have left for the round (5 max). Keep an eye on this and
  108. bet accordingly!
  109.  
  110. Other status lines will tell you what your opponent drew and what you
  111. have drawn, it will also tell you if you win or lose.
  112.  
  113. That's about it, we hope you enjoy the game and continue to support
  114. our products!
  115.  
  116.  
  117. NOTE:
  118. =====
  119.  
  120. There is no KEY file for this door, instead once registered, you will
  121. be given a CODE NUMBER to put into your SYSOP.CFG file which will
  122. unlock the door for more plays per day. Until it is registered, you
  123. are limited to one door entry per day and five plays per play. When
  124. you get your CODE number, you will also be told EXACTLY how to enter
  125. your BBS name and SYSOP name in the CFG file.
  126.  
  127. This door does not expire!
  128.  
  129. By running VIDEOP LOCAL, the SysOp can play the door without any
  130. crippling to better evaluate the door. When asked for the LOGON
  131. NAME, enter SYSOP
  132.  
  133.  
  134. FEATURES:
  135. =========
  136.            --- Desqview Aware.
  137.            --- COM0-15 support and non-standard IRQ's.
  138.            --- Colorful ANSI screens.
  139.            --- Chat function with automatic screen redraw.
  140.            --- Drop to DOS with automatic screen redraw.
  141.            --- NO BRUN module needed for play.
  142.            --- BETA tested on many different boards.
  143.            --- Will return to BBS on dropped carrier.
  144.            --- Will TIMEOUT a player after 5 minutes of no activity.
  145.            --- Use of HOT KEYS while in the door.
  146.            --- Support BBS available.
  147.            --- TOP TEN bulletins.
  148.            --- SysOp configurable.
  149.            --- Fossil Driver support.
  150.  
  151.  
  152. INSTALLATION:
  153. =============
  154. Run Strip Poker using the SPUTIL.EXE program for EASY setup!
  155.  
  156. Next, RESET the DOOR!! Select number 1 from the SPUTIL menu! This
  157. will reset everything from scratch.
  158.  
  159. Next, select number 2 from the SPUTIL menu and make sure the high
  160. score files have been reset.
  161.  
  162. Next, select number 3, set the SYSOP.CFG file -- answer all the
  163. questions here.
  164.  
  165. Finally, select number 4, set the SPOKER.CFG file.
  166.  
  167.  
  168. CONFIGURATION: (Your SPOKER.CFG file)
  169. =============
  170.  
  171. Example configuration file for PCBOARD.SYS
  172. ------------------------------------------
  173.  
  174. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  175. T&J Software        <=-  (Change this to your BBS name)
  176. Tom                 <=-  (The Sysop's first name)
  177. Wildoner            <=-  (The Sysop's last name)
  178.  
  179. Example configuration file for USERS.SYS
  180. ----------------------------------------
  181.  
  182. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  183. T&J Software        <=-  (Change this to your BBS name)
  184. Tom                 <=-  (The Sysop's first name)
  185. Wildoner            <=-  (The Sysop's last name)
  186.  
  187. Example configuration file for DOOR.SYS
  188. ---------------------------------------
  189.  
  190. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  191. T&J Software        <=-  (Change this to your BBS name)
  192. Tom                 <=-  (The Sysop's first name)
  193. Wildoner            <=-  (The Sysop's last name)
  194.  
  195. Example configuration file for USERINFO.DAT
  196. -------------------------------------------
  197.  
  198. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  199. T&J Software        <=-  (Change this to your BBS name)
  200. Tom                 <=-  (The Sysop's first name)
  201. Wildoner            <=-  (The Sysop's last name)
  202. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  203.  
  204. Example configuration file for CALLINFO.BBS
  205. -------------------------------------------
  206.  
  207. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  208. T&J Software        <=-  (Change this to your BBS name)
  209. Tom                 <=-  (The Sysop's first name)
  210. Wildoner            <=-  (The Sysop's last name)
  211.  
  212. Example configuration file for DORINFOx.DEF
  213. -------------------------------------------
  214.  
  215. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  216.                           where 'x' is the BBS Node number.
  217. T&J Software        <=-  (Change this to your BBS name)
  218. Tom                 <=-  (The Sysop's first name)
  219. Wildoner            <=-  (The Sysop's last name)
  220.  
  221. Example configuration file for SFDOORS.DAT
  222. ------------------------------------------
  223.  
  224. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  225. T&J Software        <=-  (Change this to your BBS name)
  226. Tom                 <=-  (The Sysop's first name)
  227. Wildoner            <=-  (The Sysop's last name)
  228.  
  229. Example configuration file for CHAIN.TXT
  230. ----------------------------------------
  231.  
  232. C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  233. T&J Software        <=-  (Change this to your BBS name)
  234. Tom                 <=-  (The Sysop's first name)
  235. Wildoner            <=-  (The Sysop's last name)
  236.  
  237. Example configuration file for GTUSER.BBS
  238. -----------------------------------------
  239.  
  240. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  241. T&J Software        <=-  (Change this to your BBS name)
  242. Tom                 <=-  (The Sysop's first name)
  243. Wildoner            <=-  (The Sysop's last name)
  244. 1                   <=-  (COM port number - defaults to 1)
  245. 1                   <=-  (Node number - defaults to 1)
  246.  
  247. ** Please see your individual door documentation on setting up doors!
  248.  
  249. Example Batch File
  250. ==================
  251.  
  252. A sample batch file similar to the following:
  253.    ECHO OFF
  254.    CD\DOORS\SPOKER          <=- Switch to the door's Directory.
  255.    SPOKER SPOKER.CFG        <=- Execute the door program and pass the
  256.                                 configuration filename to the program.
  257.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  258.    BOARD                    <=- Restart BBS.
  259.  
  260. This Door is multi-node  compatible so you may run more than 1 node from
  261. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  262. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  263. variables, (q.v.)
  264.  
  265. Environment Variables
  266. =====================
  267.  
  268. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  269. variables. Non-PCBoard systems may also use these variables by including
  270. the following in either your BBS batch or AUTOEXEC.BAT
  271.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  272.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  273. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  274. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  275. .CFG file for multi-node operation!
  276.  
  277. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  278. command line.  For example:
  279.  
  280.      SPOKER SPOKER.CFG /5
  281. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  282.      SPOKER SPOKER.CFG /%IRQ%
  283.  
  284. This tells the program to use IRQ 5 instead of the standard IRQ.
  285.  
  286.   Had reports of conflicts when using non-standard IRQ's on Novell/Netware
  287.  systems. Seems Novell also uses the / character so something went screwy
  288.  somewhere. So I added the * (asterisk) which may be used instead of the /
  289.  in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
  290.  and are interchangeable.
  291.  
  292. When specifying the location of the system file on line 1 of the doors .CFG
  293. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  294. and %wcnodeid%. Some examples:
  295.  PCBoard: 
  296.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  297.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  298.  
  299.  Wildcat!:
  300.    USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  301.  
  302. Non-PCBoard systems may use the PCB environment variables by setting them
  303. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  304.  SET PCBDRIVE=C:
  305.  SET PCBDIR=\BBSDIR
  306.  SET PCBNODE=1
  307.  
  308. Fossil Driver Support
  309. ---------------------
  310. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  311. Fossil driver instead of the standard COM ports, just put /FD on the command
  312. line when running the door. For example:
  313.      MYDOOR MYDOOR.CFG /FD
  314. indicates that a Fossil driver is present and should be used. If no Fossil
  315. driver is detected, DoorFrame will print a message to that effect and exit
  316. the door gracefully.
  317.  
  318.  
  319. Sysop Keys
  320. ==========
  321.  
  322. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  323.          written to DOOR.SYS and USERS.SYS
  324. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  325.          and/or written to DOOR.SYS and USERS.SYS
  326. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  327. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  328.          and/or written to DOOR.SYS and USERS.SYS
  329. F8    -  Returns the caller involuntarily to the BBS.
  330. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  331.          and/or written to DOOR.SYS and USERS.SYS
  332. F10   -  Activates SysOp CHAT mode within the DOOR.
  333. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  334. UP    -  Give the caller extra time while in the DOOR.  
  335. DN    -  Subtract time from the caller while in the DOOR. 
  336. HOME  -  HELP key for Status Line options.
  337. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  338. ALT-X -  PCBoard will exit after current caller logs off. Value is
  339.          passed to PCBoard. Not available on non-PCBoard systems.
  340.  
  341.  
  342. SYSOP.CFG FILE:
  343. ==============
  344.  
  345. 10
  346. c:\wc30\bull\bull99.scr
  347. c:\wc30\bull\bull99.bbs
  348. 2
  349. 5000
  350. 0
  351.  
  352. LINE 1: Plays per entry into the door.  (30-50 recommended)
  353. LINE 2: Color bulletin path
  354. LINE 3: Mono bulletin path
  355. LINE 4: Entries per day.
  356. LINE 5: Starting money. I'd leave this at 5000.
  357. LINE 6: Your REGISTRATION CODE  0 if not registered.
  358.  
  359.  
  360. MAINTENANCE:
  361. ===========
  362.  
  363. After the initial setup, this door resets by itself with the first
  364. player every monday! No need for external maintenance!
  365.  
  366.  
  367. PLAYING LOCALLY:
  368. ===============
  369.  
  370. Just type SPOKER LOCAL and logon as SYSOP
  371.  
  372.  
  373. FUTURE VERSIONS:
  374. ================
  375.  
  376. COMMENTS & QUESTIONS:
  377. ====================
  378.  
  379. Q: I'm running DESQview/X and the door is having some problems with
  380.    keyboard timeouts and things like that!!
  381. A: Make sure you have the MATH COPROCESSOR flagged ON, even if you don't
  382.    have one! This is a problem with DV/X and not the door.
  383.  
  384. Q: I keep getting an error #53 right when the door starts!!
  385. A: Error #53 means a file is not found. If this occurs right from the
  386.    start, odds are the door isn't finding the caller information file.
  387.    Check the PATH to your caller information file located located
  388.    on the first line of the SPOKER.CFG file.
  389.  
  390.  
  391. PROBLEMS:
  392. ========
  393.  
  394. If any internal errors do occur, check for a file called DFRAME.ERR
  395. and let me know what the error code says.
  396.  
  397. Several people have been having problems with their Trident SVGA
  398. cards and the ANSI screens not showing up correctly. To fix this,
  399. check you utility disk that came with your Trident card for a program
  400. called TANSI.SYS or something similar. Replace your old ANSI.SYS
  401. with this version of it. This will correct the problems.
  402.  
  403. Please feel free to contact me if you have any problems at all.
  404.  
  405.  
  406.                             QuickBasic Error codes
  407.                       DoorFrame uses the QB error codes.
  408.  ---------------------------------------------------------------------------
  409.  
  410.  2   Syntax Error                       61   Disk full
  411.  5   Ilegal Function Call               62   Input past end of File
  412.  6   Overflow                           63   Bad record number
  413.  7   Out of memory                      64   Bad filename
  414. 11   Division by Zero                   67   Too many files
  415. 13   type mismatch                      68   Device unavailable
  416. 24   Device Timeout                     69   Comm-buffer overflow
  417. 25   Device fault                       70   Permission denied
  418. 52   Bad filename or number             71   Disk not ready
  419. 53   File Not Found                     72   Disk media error
  420. 55   File Already open                  74   Rename across disk
  421. 57   Device I/O error                   75   Path/File access error
  422. 58   File already exists                76   Path not found
  423. 59   Bad Record length
  424.  
  425.      The most common error that you will see is #62.  This is usually caused
  426. by the CFG file not having enough lines.  I have included this list so
  427. that you may be able to fix a problem that occurs with a T&J Software
  428. door.
  429.  
  430. VERSION HISTORY:
  431. ===============
  432. See the HISTORY.TXT file for information on the history of the game
  433. and the new options in the new versions!
  434.  
  435. REGISTERING:
  436. ============
  437. That's all there is to it! If you have any problems or questions
  438. please feel free to call the T&J BBS at (717)325-9481 and join the
  439. T&J Software Conference.
  440.  
  441. See the enclosed registration form for ordering!  (REGISTER.TXT)
  442.